<html>
<head><meta charset="utf-8"><title>Glossary · t-lang/wg-unsafe-code-guidelines · Zulip Chat Archive</title></head>
<h2>Stream: <a href="https://rust-lang.github.io/zulip_archive/stream/136281-t-lang/wg-unsafe-code-guidelines/index.html">t-lang/wg-unsafe-code-guidelines</a></h2>
<h3>Topic: <a href="https://rust-lang.github.io/zulip_archive/stream/136281-t-lang/wg-unsafe-code-guidelines/topic/Glossary.html">Glossary</a></h3>

<hr>

<base href="https://rust-lang.zulipchat.com">

<head><link href="https://rust-lang.github.io/zulip_archive/style.css" rel="stylesheet"></head>

<a name="171761023"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/136281-t-lang/wg-unsafe-code-guidelines/topic/Glossary/near/171761023" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> RalfJ <a href="https://rust-lang.github.io/zulip_archive/stream/136281-t-lang/wg-unsafe-code-guidelines/topic/Glossary.html#171761023">(Jul 26 2019 at 09:47)</a>:</h4>
<p><span class="user-mention" data-user-id="224471">@Lokathor</span> btw, we have like 3 or 4 PRs open that edit the glossary, so I think it'll be a while until you can do the alphabetic reordering</p>



<a name="171761071"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/136281-t-lang/wg-unsafe-code-guidelines/topic/Glossary/near/171761071" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> RalfJ <a href="https://rust-lang.github.io/zulip_archive/stream/136281-t-lang/wg-unsafe-code-guidelines/topic/Glossary.html#171761071">(Jul 26 2019 at 09:48)</a>:</h4>
<p>also I am not sold on your idea to wrap it to 80 lines. I am a big fan of one-sentence-per line for LaTeX and markdown sources. it makes the diff much more meaningful.</p>



<a name="171833744"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/136281-t-lang/wg-unsafe-code-guidelines/topic/Glossary/near/171833744" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Lokathor <a href="https://rust-lang.github.io/zulip_archive/stream/136281-t-lang/wg-unsafe-code-guidelines/topic/Glossary.html#171833744">(Jul 27 2019 at 07:18)</a>:</h4>
<p>Well that's fine if you want to go that route<br>
most people don't look at the raw markdown anyway, so it's not a big deal. I just like wrapped paragraphs when looking at it in my editor because code and code comments are also generally wrapped, and so text overall is a little more consistent that way</p>



<a name="171833921"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/136281-t-lang/wg-unsafe-code-guidelines/topic/Glossary/near/171833921" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> RalfJ <a href="https://rust-lang.github.io/zulip_archive/stream/136281-t-lang/wg-unsafe-code-guidelines/topic/Glossary.html#171833921">(Jul 27 2019 at 07:24)</a>:</h4>
<p>yeah it's a somewhat arbitrary decision either way. I am writing a lot of LaTeX these days and just format my markdown the same when tidy does not prevent me from it. ;)</p>



<a name="171834056"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/136281-t-lang/wg-unsafe-code-guidelines/topic/Glossary/near/171834056" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> Lokathor <a href="https://rust-lang.github.io/zulip_archive/stream/136281-t-lang/wg-unsafe-code-guidelines/topic/Glossary.html#171834056">(Jul 27 2019 at 07:28)</a>:</h4>
<p>alright we'll skip on wrapping and just do alphabetization once the glossary settles down</p>



<a name="171904452"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/136281-t-lang/wg-unsafe-code-guidelines/topic/Glossary/near/171904452" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> RalfJ <a href="https://rust-lang.github.io/zulip_archive/stream/136281-t-lang/wg-unsafe-code-guidelines/topic/Glossary.html#171904452">(Jul 28 2019 at 21:13)</a>:</h4>
<p>speaking of which, I think we should also make the items of the glossary into <code>###</code> headers. right now we use <code>####</code> and that has the same font size as <code>**bold text**</code>, which makes this look confusing: <a href="https://github.com/rust-lang/unsafe-code-guidelines/blob/master/reference/src/glossary.md#pointer-provenance" target="_blank" title="https://github.com/rust-lang/unsafe-code-guidelines/blob/master/reference/src/glossary.md#pointer-provenance">https://github.com/rust-lang/unsafe-code-guidelines/blob/master/reference/src/glossary.md#pointer-provenance</a></p>



<a name="171904454"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/136281-t-lang/wg-unsafe-code-guidelines/topic/Glossary/near/171904454" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> RalfJ <a href="https://rust-lang.github.io/zulip_archive/stream/136281-t-lang/wg-unsafe-code-guidelines/topic/Glossary.html#171904454">(Jul 28 2019 at 21:13)</a>:</h4>
<p>"Using provenance to track originating allocation" is a sub-header, and "Interior mutability" is the next actual header, but they have the same size and font...</p>



<a name="171904495"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/136281-t-lang/wg-unsafe-code-guidelines/topic/Glossary/near/171904495" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> RalfJ <a href="https://rust-lang.github.io/zulip_archive/stream/136281-t-lang/wg-unsafe-code-guidelines/topic/Glossary.html#171904495">(Jul 28 2019 at 21:14)</a>:</h4>
<p>glossary PRs currently open:<br>
<a href="https://github.com/rust-lang/unsafe-code-guidelines/pull/153" target="_blank" title="https://github.com/rust-lang/unsafe-code-guidelines/pull/153">https://github.com/rust-lang/unsafe-code-guidelines/pull/153</a><br>
<a href="https://github.com/rust-lang/unsafe-code-guidelines/pull/180" target="_blank" title="https://github.com/rust-lang/unsafe-code-guidelines/pull/180">https://github.com/rust-lang/unsafe-code-guidelines/pull/180</a></p>



<a name="171941293"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/136281-t-lang/wg-unsafe-code-guidelines/topic/Glossary/near/171941293" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> gnzlbg <a href="https://rust-lang.github.io/zulip_archive/stream/136281-t-lang/wg-unsafe-code-guidelines/topic/Glossary.html#171941293">(Jul 29 2019 at 12:34)</a>:</h4>
<blockquote>
<p>"Using provenance to track originating allocation" is a sub-header, and "Interior mutability" is the next actual header, but they have the same size and font...</p>
</blockquote>
<p>We should open an issue with mdbook, and ask whether there is something that can be done about it at that level, or what would be the simplest way for us to tune it. </p>
<p>I somehow would expect the <code>###...</code>s to be translated to <code>&lt;hN&gt;</code> html tags, but maybe something cleverer is going on ? If these actually generate <code>&lt;hN&gt;</code> tags, then its actually an issue that has to be filled with your web-browser, since for 2 different <code>N</code>s, those shouldn't be rendered equally.</p>



<a name="171943980"></a>
<h4><a href="https://rust-lang.zulipchat.com#narrow/stream/136281-t-lang/wg-unsafe-code-guidelines/topic/Glossary/near/171943980" class="zl"><img src="https://rust-lang.github.io/zulip_archive/assets/img/zulip.svg" alt="view this post on Zulip" style="width:20px;height:20px;"></a> RalfJ <a href="https://rust-lang.github.io/zulip_archive/stream/136281-t-lang/wg-unsafe-code-guidelines/topic/Glossary.html#171943980">(Jul 29 2019 at 13:14)</a>:</h4>
<p>my guess is the style just makes the <code>h4</code> (or whatever <code>####</code> ends up as) the same size as normal text</p>



<hr><p>Last updated: Aug 07 2021 at 22:04 UTC</p>
</html>